package com.push_label.config;

import com.fasterxml.jackson.annotation.JsonInclude;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
import com.fasterxml.jackson.datatype.jsr310.deser.LocalDateTimeDeserializer;
import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateTimeSerializer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

/**
 * Jackson JSON 序列化/反序列化配置类
 * 用于自定义 ObjectMapper 的配置
 */
@Configuration
public class JacksonConfig {

    /**
     * 创建并配置 ObjectMapper Bean
     * ObjectMapper 是 Jackson 库的核心类，用于 JSON 的序列化和反序列化
     *
     * @return 配置好的 ObjectMapper 实例
     */
    @Bean
    public ObjectMapper objectMapper() {
        // 创建 ObjectMapper 实例
        ObjectMapper mapper = new ObjectMapper();
        
        // 设置序列化配置：只序列化非空字段
        // 当字段值为 null 时，不会包含在 JSON 输出中
        mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);

        // 创建 JavaTimeModule 用于处理 Java 8 时间 API
        JavaTimeModule timeModule = new JavaTimeModule();
        
        // 定义日期时间格式
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
        
        // 注册 LocalDateTime 的反序列化器
        // 将字符串按照指定格式解析为 LocalDateTime 对象
        timeModule.addDeserializer(
            LocalDateTime.class, 
            new LocalDateTimeDeserializer(formatter)
        );
        
        // 注册 LocalDateTime 的序列化器
        // 将 LocalDateTime 对象按照指定格式序列化为字符串
        timeModule.addSerializer(
            LocalDateTime.class, 
            new LocalDateTimeSerializer(formatter)
        );
        
        // 将时间模块注册到 ObjectMapper
        mapper.registerModule(timeModule);

        return mapper;
    }
}